home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 4: GNU Archives / Linux Cubed Series 4 - GNU Archives.iso / gnu / fontutil.6 / fontutil / fontutils-0.6 / include / global.h < prev    next >
Encoding:
C/C++ Source or Header  |  1992-09-06  |  7.8 KB  |  210 lines
  1. /* global.h: extend the standard programming environment a little.  This
  2.    is included from config.h, which everyone includes.
  3.  
  4. Copyright (C) 1992 Free Software Foundation, Inc.
  5.  
  6. This program is free software; you can redistribute it and/or modify
  7. it under the terms of the GNU General Public License as published by
  8. the Free Software Foundation; either version 2, or (at your option)
  9. any later version.
  10.  
  11. This program is distributed in the hope that it will be useful,
  12. but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14. GNU General Public License for more details.
  15.  
  16. You should have received a copy of the GNU General Public License
  17. along with this program; if not, write to the Free Software
  18. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19.  
  20. #ifndef GLOBAL_H
  21. #define GLOBAL_H
  22.  
  23. #include "lib.h"
  24. #include "types.h"
  25.  
  26. /* Define common sorts of messages.  */
  27.  
  28. /* This should be called only after a system call fails.  */
  29. #define FATAL_PERROR(s) do { perror (s); exit (errno); } while (0)
  30.  
  31.  
  32. #define START_FATAL() do { fputs ("fatal: ", stderr)
  33. #define END_FATAL() fputs (".\n", stderr); exit (1); } while (0)
  34.  
  35. #define FATAL(s)                            \
  36.   START_FATAL (); fprintf (stderr, "%s", s); END_FATAL ()
  37. #define FATAL1(s, e1)                            \
  38.   START_FATAL (); fprintf (stderr, s, e1); END_FATAL ()
  39. #define FATAL2(s, e1, e2)                        \
  40.   START_FATAL (); fprintf (stderr, s, e1, e2); END_FATAL ()
  41. #define FATAL3(s, e1, e2, e3)                        \
  42.   START_FATAL (); fprintf (stderr, s, e1, e2, e3); END_FATAL ()
  43. #define FATAL4(s, e1, e2, e3, e4)                    \
  44.   START_FATAL (); fprintf (stderr, s, e1, e2, e3, e4); END_FATAL ()
  45.  
  46.  
  47. #define START_WARNING() do { fputs ("warning: ", stderr)
  48. #define END_WARNING() fputs (".\n", stderr); fflush (stderr); } while (0)
  49.  
  50. #define WARNING(s)                            \
  51.   START_WARNING (); fprintf (stderr, "%s", s); END_WARNING ()
  52. #define WARNING1(s, e1)                            \
  53.   START_WARNING (); fprintf (stderr, s, e1); END_WARNING ()
  54. #define WARNING2(s, e1, e2)                        \
  55.   START_WARNING (); fprintf (stderr, s, e1, e2); END_WARNING ()
  56. #define WARNING3(s, e1, e2, e3)                        \
  57.   START_WARNING (); fprintf (stderr, s, e1, e2, e3); END_WARNING ()
  58. #define WARNING4(s, e1, e2, e3, e4)                    \
  59.   START_WARNING (); fprintf (stderr, s, e1, e2, e3, e4); END_WARNING ()
  60.  
  61. /* Define useful abbreviations.  */
  62.  
  63. /* This is the maximum number of numerals that result when a 64-bit
  64.    integer is converted to a string, plus one for a trailing null byte,
  65.    plus one for a sign.  */
  66. #define MAX_INT_LENGTH 21
  67.  
  68. /* Printer's points, as defined by TeX (and good typesetters everywhere).  */
  69. #define POINTS_PER_INCH  72.27
  70.  
  71. /* Convert a number V in pixels to printer's points, and vice versa,
  72.    assuming a resolution of DPI pixels per inch.  */
  73. #define PIXELS_TO_POINTS(v, dpi) (POINTS_PER_INCH * (v) / (dpi))
  74. #define POINTS_TO_REAL_PIXELS(v, dpi) ((v) * (dpi) / POINTS_PER_INCH)
  75. #define POINTS_TO_PIXELS(v, dpi) ((int) (POINTS_TO_REAL_PIXELS (v, dpi) + .5))
  76.  
  77. /* Some simple numeric operations.  It is possible to define these much
  78.    more cleanly in GNU C, but we haven't done that (yet).  */
  79. #define SQUARE(x) ((x) * (x))
  80. #define CUBE(x) ((x) * (x) * (x))
  81. #define    SAME_SIGN(u,v) ((u) >= 0 && (v) >= 0 || (u) < 0 && (v) < 0)
  82. #define ROUND(x) ((int) ((int) (x) + .5 * SIGN (x)))
  83. #define SIGN(x) ((x) > 0 ? 1 : (x) < 0 ? -1 : 0)
  84.  
  85. #ifndef MAX
  86. #define MAX(a, b) ((a) > (b) ? (a) : (b))
  87. #endif
  88. #ifndef MIN
  89. #define MIN(a, b) ((a) < (b) ? (a) : (b))
  90. #endif
  91.  
  92. /* Too bad C doesn't define operators for these.  */
  93. #define MAX_EQUALS(var, expr) if ((expr) > (var)) (var) = (expr)
  94. #define MIN_EQUALS(var, expr) if ((expr) < (var)) (var) = (expr)
  95.  
  96. #define STREQ(s1, s2) (strcmp (s1, s2) == 0)
  97.  
  98. /* Declarations for commonly-used routines we provide ourselves.  The
  99.    ones here are only needed by us, so we do not provide them in
  100.    unprototyped form.  Others are declared both ways in lib.h.  */
  101.  
  102. /* Return the current date and time a la date(1).  */
  103. extern string now (void);
  104.  
  105. /* Check if a string is a valid floating-point or decimal integer.
  106.    Returns false if passed NULL.  */
  107. extern boolean float_ok (string);
  108. extern boolean integer_ok (string);
  109.  
  110. /* Like `atoi', but disallow negative numbers.  */
  111. extern const unsigned atou (string);
  112.  
  113. /* The converses of atoi, atou, and atof.  These all return dynamically
  114.    allocated strings.  `dtoa' is so-named because `ftoa' is a library
  115.    function on some systems (the IBM RT), and the loader complains that
  116.    is defined twice, for reasons I don't understand.  */
  117. extern string itoa (int);
  118. extern string utoa (unsigned);
  119. extern string dtoa (double);
  120.  
  121. /* Like their stdio counterparts, but abort on error, after calling
  122.    perror(3) with FILENAME as its argument.  */
  123. extern FILE *xfopen (string filename, string mode);
  124. extern void xfclose (FILE *, string filename);
  125. extern void xfseek (FILE *, long, int, string filename);
  126. extern four_bytes xftell (FILE *, string filename);
  127.  
  128. /* Copies the file FROM to the file TO, then unlinks FROM.  */
  129. extern void xrename (string from, string to);
  130.  
  131. /* Return NAME with any leading path stripped off.  This returns a
  132.    pointer into NAME.  */
  133. extern string basename (string name);
  134.  
  135.  
  136.  
  137. /* If P or *P is null, abort.  Otherwise, call free(3) on P,
  138.    and then set *P to NULL.  */
  139. extern void safe_free (address *p);
  140.  
  141.  
  142. /* Math functions.  */
  143.  
  144. /* Says whether V1 and V2 are within REAL_EPSILON of each other.
  145.    Fixed-point arithmetic would be better, to guarantee machine
  146.    independence, but it's so much more painful to work with.  The value
  147.    here is smaller than can be represented in either a `fix_word' or a
  148.    `scaled_num', so more precision than this will be lost when we
  149.    output, anyway.  */
  150. #define REAL_EPSILON 0.00001
  151. extern const boolean epsilon_equal (real v1, real v2);
  152.  
  153. /* Arc cosine, in degrees.  */
  154. extern const real acosd (real);
  155.  
  156. /* Return the Euclidean distance between the two points.  */
  157. extern const real distance (real_coordinate_type, real_coordinate_type);
  158. extern const real int_distance (coordinate_type, coordinate_type);
  159.  
  160. /* Slope between two points (delta y per unit x).  */
  161. extern const real slope (real_coordinate_type, real_coordinate_type);
  162.  
  163. /* Make a real coordinate from an integer one, and vice versa.  */
  164. extern const real_coordinate_type int_to_real_coord (coordinate_type);
  165. extern const coordinate_type real_to_int_coord (real_coordinate_type);
  166.  
  167. /* Test if two integer points are adjacent.  */
  168. extern const boolean points_adjacent_p (int row1, int col1, int r2, int c2);
  169.  
  170. /* Find the largest and smallest elements of an array.  */
  171. extern void find_bounds (real values[], unsigned value_count,
  172.                      /* returned: */ real *the_min, real *the_max);
  173.  
  174. /* Make all the elements in the array between zero and one.  */
  175. extern real *map_to_unit (real * values, unsigned value_count);
  176.  
  177.  
  178. /* String functions.  */
  179.  
  180. /* Return (a fresh copy of) SOURCE beginning at START and ending at
  181.    LIMIT.  (Or NULL if LIMIT < START.)  */
  182. extern string substring (string source, const unsigned start,
  183.                          const unsigned limit);
  184.  
  185. /* Change all uppercase letters in S to lowercase.  */
  186. extern string lowercasify (string s);
  187.  
  188.  
  189. /* Character code parsing.  */
  190.  
  191. /* If the string S parses as a character code, this sets *VALID to
  192.    `true' and returns the number.  If it doesn't, it sets *VALID to
  193.    `false' and the return value is garbage.
  194.    
  195.    We allow any of the following possibilies: a single character, as in
  196.    `a' or `0'; a decimal number, as in `21'; an octal number, as in `03'
  197.    or `0177'; a hexadecimal number, as in `0x3' or `0xff'.  */
  198. extern charcode_type parse_charcode (string s, boolean *valid);
  199.  
  200. /* Like `parse_charcode', but gives a fatal error if the string isn't a
  201.    valid character code.  */
  202. extern charcode_type xparse_charcode (string s);
  203.  
  204. /* The environment variable name with which to look up auxiliary files.  */
  205. #ifndef LIB_ENVVAR
  206. #define LIB_ENVVAR "FONTUTIL_LIB"
  207. #endif
  208.  
  209. #endif /* not GLOBAL_H */
  210.